perm filename MSMAN[MSS,LCS] blob sn#383503 filedate 1978-09-19 generic text, type T, neo UTF8
00100	
00200	The MS program can create scores  with as many staves as desired,  however
00300	only up to 8 staves may appear on the CRT display at one time. Due to  the
00400	limitations of the display system it is best to deal with as few staves at
00500	a time as is convenient.  The dispayable staves are numbered zero  through
00600	7 with 0 appearing at the bottom of the screen.
00700	
00800	Each object  used  in  a  musical score  will  be  numbered  automatically
00900	according to its order of entry.   These objects are known as "Items"  and
01000	each Item will be  associated with a particular  staff number.  Each  Item
01100	will be  defined  in  terms  of  a string  of  parameters.   The  first  4
01200	parameters for each Item will conform to the following conventions.
01300	
01400	
01500		P1	will contain the special code number for each Item.
01600			For example the code number for notes is 1; 
01700			for rests, 2; for clefs, 3; etc.
01800	
01900		P2	will indicate the staff (0 to 7) to which the Item is
02000			attached.  The vertical size of a staff will determine
02100			the basic size of each Item associated with that staff.
02200	
02300		P3	will indicate the horizontal position of each Item. The
02400			normal full screen width has a range of numbers from
02500			0 to 200.  Position 100 is at the center of the screen.
02600			P3 numbers are absolute.  They are unaffected by staff
02700			size.  Floating point numbers may be used in this and
02800			most following parameters.  (The position numbers will 
02900			usually refer to the position of the left leading edge 
03000			of an object.)
03100	
03200		P4	sets the vertical position of each Item.  Vertical position
03300			will always be relative to the vertical position of the
03400			staff involved.  The position numbers are related to the
03500			numbering of the notes of the diatonic scale beginning
03600			with middle C=1.  The treble clef is assumed for this
03700			purpose.  Thus a note with P4 set to 1 would appear on
03800			the first ledger line below the staff.  The bottom line
03900			of the staff is position 3.  (The musical interval from
04000			C to E is a third.)  The first space in the staff is
04100			position 4, the top space is position 10, etc.  The analogy
04200			to musical intervals holds only when ascending from
04300			position 1.  Descending, the next position is 0 (for B
04400			below middle C), then -1 for A, -2 for G, etc.  Note that
04500			the actual clef used is not pertinent here; 1 will put a
04600			note on the first ledger line below the staff no matter
04700			what clef has appeared.  For many Items P4 will indicate
04800			the position of the bottom or middle (as with notes) of
04900			the Item, however there are many exceptions to this (clefs,
05000			rests, etc.)
05100	
05200		The  higher  parameter  numbers  will serve various functions
05300	depending on the code number (P1) involved.
05400	
05500	
05600	
     

00100		A guide to spacing may be made to appear  on  the  screen  by
00200	typing  SC  n <cr> , where n is a staff number.  (SC = spacing scale)
00300	Upward from the bottom of the screen,  on  the  far  left  side,  the
00400	numbers 0 to 7 will appear.  These refer to the numbered positions of
00500	the staves.  Horizontally, at the level of whatever staff number that
00600	has  been  given  following  SC,  the  scale is printed by tens in an
00700	abbreviated form running from 0 to 9 (= 0 to 90), 0 to 9 again (= 100
00800	to 190) and then a final 0 (= 200).  To move the scale to a different
00900	staff level just type SC n <cr> with a new value for n.  To erase the
01000	spacing  scale  entirely, type SC 99 <cr>.  It is usually a good idea
01100	to have the spacing scale visible when any editing is being done.
     

00100	
00200		Setting up the musical staff.
00300	
00400		
00500		Usually  the  first step in entering a score is to set up the
00600	staff.  The parameter list for a staff is as follows:
00700	
00800	| P1 | P2   |  P3 |   P4   |  P5  |  P6 |  P7	  |   P8   |      P9	  |
00900	|Code|Staff |Left |Relative| Size |Right|Visible, |Location|Identification|
01000	|Num.| Num. |side |vertical|factor|side |invisible|   of   |     name	  |
01100	|(8) |(Basic| of  |position|      | of  |	  |spacing |		  |
01200	|    | vert.|staff|	   |      |staff|	  |  line  |		  |
01300	|    | pos.)|     |	   |      |     |	  |	   |		  |
01400	|    |(0to7)|     |	   |      |     |	  |	   |		  |
01500	
01600		Normally a zero in P2 will put a staff near the bottom of the
01700	display.  However a staff zero may be  made  to  appear  anywhere  by
01800	changing the number in P4. The vertical spacing units used in P4 will
01900	be called "note level units." There are two note level units from one
02000	staff line to the next. Thus if P4 = 2 the staff will appear 2 levels
02100	higher than the basic position.  P4 = -10 would put the staff down 10
02200	note levels.
02300	
02400		The  actual  size of each note level unit depends on the size
02500	factor number in P5. When the program begins P5 is set to 1 for all 8
02600	staves.  If  P5  equals 2, then the size of each note level unit will
02700	double. P5 = .8 will make the note level units 80% of the basic size.
02800	The  size factor of a staff will influence every Item associated with
02900	that same staff.  Thus all the notes on a staff with P5 = .5  will be
03000	half as  large  as  the notes on a staff with P5 = 1.  The horizontal
03100	position numbers (0 to 200) are not affected by the P5 size factor of
03200	the staff.
03300	
03400		P3 and P6 control the actual width of the staff. The original
03500	values for these are 0 and 200. To make a staff occupy only the right
03600	half of the screen set P3 to 100.  (If P6 is left at 0 it becomes the
03700	default value of 200.) To make it occupy only the left half set P3 to
03800	0 and P6 to 100. The horizontal spacing units will remain constant at
03900	all times.  With most  Items  which  have  variable  left  and  right
04000	position points, such as slurs, beams, various lines, etc., P3 and P6
04100	are used to specify the left and right locations.
04200	
04300		Normally P7 is left at zero, however it is  sometimes  useful
04400	to  have items associated with a staff size factor different from any
04500	of those staves which are visible.  When P7 is set  to  1  the  staff
04600	lines will be invisible but whatever values are given to P4 (vertical
04700	note level position) and P5 (size factor will then serve as the bases
04800	for all items using the same staff number (P2.)
04900	
     

00100	
00200		P8 is used to aid in spacing groups of  staves  when  several
00300	separate  display  units  (files) are assembled to print a full page.
00400	The use of this feature will be explained later.
00500	
00600		P9 can be made to hold a special identification name for each
00700	staff.  These names are needed  when  the  automatic  part-extraction
00800	program is used.  This program will be dealt with later.
00900	
01000		The following examples should be tried  to  gain  familiarity
01100	with the  staff  placement.  All entries must be terminated with <cr>
01200	(the return key.)
01300	
01400		To start  the  operation  of the program type R MS <cr>.  The
01500	program will respond with "TYPE FOR ITEM 1". To put the spacing scale
01600	on the  screen  type  SC0 <cr>.  The scale will appear and the prompt
01700	will be repeated.
01800	
01900		Then type 8 <cr>.
     

00100		You now have a full-length staff at position zero, the bottom
00200	of  the  screen,  with  a  size factor of 1.  Since only P1 (the code
00300	number) has been given here all the default values for the  remaining
00400	parameters are assumed by the program.  Now try,
00500	
00600		8 5 50 (always followed by <cr>.)
00700	
00800		In this case a staff will appear at staff position 5 with the
00900	left  end  located  1/4  of the way (horizontal position 50) from the
01000	left side of the screen.
01100	
01200		8 3 0 0 .8
01300	
01400		This will put a staff  at  position  3,  the  middle  of  the
01500	screen,  vertically.  The size factor, in P5, will cause the staff to
01600	be 80% of the vertical size of the other staves.  Now try,
01700	
01800		8 7 0 0 1.1 100
01900	
02000		This will put a staff near the top of the screen, position 7.
02100	The size factor, 1.1, will  cause  it  to  be  10%  larger  than  the
02200	standard  and the 100 in P6 will cause the right side of the staff to
02300	end at the center of the screen.  The screen nw looks like this.
02400	
     

00100	Editing
00200	
00300		Any of  the items appearing on the screen may be edited.  The
00400	several methods for locating the parameters of particular items  will
00500	be explained  later.  Each item is given a number internally as it is
00600	entered.  To bring forth an item for editing simply type "I" followed
00700	by the proper number. Thus typing I1 <cr> will make a cursor (marker)
00800	appear at the left leading edge of the first staff entered.  Also the
00900	list of  parameters  for that item will be printed on the screen.  At
01000	this point any of  the  parameters  may  be  changed  by  typing  the
01100	parameter number followed by the change desired.
01200	
01300		If  4  1 is typed the new vertical position of the staff will
01400	appear superimposed on the original staff. Since P4 now has a 1 in it
01500	the whole staff has been moved up 1 note level unit. The lines of the
01600	new form of the staff will appear in the spaces of the original form.
01700	The original parameter list will print out once more. Now if "X" (for
01800	"exit from edit mode") is typed the original form of the  staff  will
01900	disappear leaving  only  the altered version.  The list of parameters
02000	will also disappear.  The screen will say  "TYPE FOR ITEM 5",  (there
02100	are already  4 items on the screen.)  New items may now be entered or
02200	further editing may be done.
02300	
02400		To re-edit  the  first  staff  type "I1" again.  (No space is
02500	needed between I and 1.)  The parameter list for item 1 will now show
02600	a 1 in P4.  If 4 -1 is typed the staff will appear 2 note level units
02700	below its current position.  4 3 will superimpose it  2  note  levels
02800	above its  current position.  In all these cases an absolute value is
02900	being given for P4.  Relative values may be given by adding two zeros
03000	to the parameter  number.  (Or, if you prefer, PnX100.)  Thus, typing
03100	400 -3 will cause the edited version of the  staff  to  move  down  3
03200	units from  whatever  level  it may be at.  If all the previous steps
03300	have been typed as indicated the edited position will now be at level
03400	zero.
03500	
03600		Several parameters may be changed at one time by typing pairs
03700	of numbers. The parameter numbers need not be given in order.  3 10 6
03800	190 400 4 will move the left and right sides of the staff (P3 and P6)
03900	each  in  toward the center by 10 horizontal units and the staff will
04000	be moved up by 4 note level units.  (P4 is listed as 400 to  cause  a
04100	relative  shift.)  Typing  an  "X"  will once more exit from the edit
04200	mode.
     

00100	
00200	
00300	
00400	
00500	
00600	
00700	
00800	
00900	
01000	
01100	
01200	
01300	
01400	
01500	
01600	
01700	
01800	
01900	
02000	
02100	
02200	
02300	
02400	
02500	
02600	
02700	
02800	
02900	
03000	
03100	
03200	
03300	
03400	
03500	
03600	
03700	
03800	
03900	
04000	
04100	
04200		If nothing is typed at this point and instead of an "X"  (for
04300	exit)  the  <cr>  key is struck the editing of item 1 will cease, the
04400	old form of item 1 will disappear leaving only the  edited  form  and
04500	the  cursor  will  move  on  to item 2 and its parameter list will be
04600	printed.  Further carriage returns will step  through  the  items  in
04700	order.  When  there are no more items found the cursor will no longer
04800	appear (you will be out of edit mode) and the program will  wait  for
04900	other commands.
05000	
     

00100		To edit the last item entered or edited no number  is  needed
00200	after  the  letter  I.  In this set of examples typing I <cr> will go
00300	into edit mode for item 4.  To back up from this point, -2  <cr>  (no
00400	"I")  will move to item 2, or I2 <cr> would do the same thing.  These
00500	last mentioned commands will work only if there have been no  changes
00600	made  in the item currently indicated by the cursor.  If changes have
00700	been made single negative numbers or the letter I will be ignored  by
00800	the  program.  The only valid commands are further parameter changes,
00900	an "X" or <cr> to terminate the editing of  that  item,  the  letters
01000	L,R,U,D,  the  letter  "C"  (for  COPY),  "P" followed by a parameter
01100	number or "DEL".
01200	
01300		The letters L, R, U and D, followed by a number, may be  used
01400	for  moving  an  item  left, right, up or down. L6 <cr>, for example,
01500	would move an item 6 units to the left. D4 would move it 4 note level
01600	units down. L5.5 U7 <cr> would move it left 5.5 units and up 7 units.
01700	If no number is given after one of these letters the number last used
01800	for  that  coordinate  will  be  applied. D6 will move an item down 6
01900	units. If U <cr> is then typed the item will go up 6 units - or  back
02000	to  its  original  position. When no number is used only one of these
02100	letter commands may be used at a time.
02200	
02300		With "C" the original form of the item remains unchanged  and
02400	a  copy  of the item in the edited form is added on to the total list
02500	of items. Here a special situation arises when dealing  with  staves.
02600	The  only point in using "C" with staves is if the list of parameters
02700	changes includes a change in P2, the staff number.  For example, type
02800	I1.  The parameter list will now show:
02900	
03000		8 0 10 4 0 190	(The  size factor is actually 1 even though a
03100	zero appears in P5.)
03200	
03300		Then type 2 1 400 -6. This will put the edited form of item 1
03400	up  to  staff  position 1 but with a relative shift down 6 note level
03500	units from where it would otherwise appear. Now C <cr> will make this
03600	form  of  item 1 into item 5 and the program will exit from edit mode
03700	and say, "TYPE FOR ITEM 6".
     

00100		Each  time  parameters  are  changed  while  in edit mode the
00200	original list of parameters is printed out.  To see the exact  edited
00300	value of any parameter, type Pn, where n is a parameter number.  Only
00400	one parameter at a time may be examined in this manner.
00500	
00600		Once in edit mode, an item may be deleted by typing DEL <cr>.
00700	If  any  changes have been made before, this command will be ignored.
00800	So to delete item 2, type I2 <cr>, then DEL <cr>.  Item 2 (the  staff
00900	that  was at position 5) has now disappeared and the cursor has moved
01000	on to the next item.  Internally, all the items  are  now  renumbered
01100	from this item on.  If this next item is not to be changed, then type
01200	X to exit from edit mode.
01300